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CHAFTER 1 

RTOS DRIVER IMPLEME-NTATION 

INTRODUCTION 

In all real time computer control systems, the CPU reacts to input data from a real 
world environment and provides output data to correct or control the enyironment. 
The incoming data is normally the result of a process device interrupt or an input- 
output operation completion interrupt. In general these interrupts differ from one 
another only in the way in which they axe serriced. 

When a significant event occurs, a signal is transmitted to the computer as an 
interrupt requiring a special subroutine to take appropriate action. Interrupts are 
usually assigned in order oi urgency or priority, so that if two interrupts occur at 
the same moment, the more important interrupt is serviced first by the computer. 

How well a computer is able to respond to interrups generally determines the max- 
imum capability of the real time system. A significant element in the responsive 
ability of any real time system is the inclusion of a powerful and flexible multi- 
priority interrupt control program. 

This document outlines the methods of adding customer -assignable multi- priority 
servicing routines. These device drivers can be included as part of the resident 
RTOS operating system or they can be implemented as part of the user application 
program and attached to the interrupt dispatch program. 

CHARACTERISTICS OF INTERRUPTS 

Interrupts can be generated by conditions internal to the computer hardware itself 

(power monitor o|*ion), or by events which originate in the plant or the environmeii: 
that is being controlled (an external hardware interrupt like an analog -to -digital 
converter completion). 

Non-process interrupts may be caused by an error condition being detected, an interval 
timer run-down, an input-output (I/O) complete interrupt, etc. The I/O interrupt is 
characterized by the completion of an I/O device operation such as a paper tape or 
disk storage transfer function, which may involve the reading or writing of one 
character or word in the case of program control or multiple words in the case of 
data channel operation. The concei* of this ty|^ of interrupt is based on the impor- 
tance of keeping I/O devices active, thus improving Job throughput. 

Rrocess interrupts reflect process conditions v/hich have been detected and which 
require an immediate change in program execution, such as may be caused by the 
closing of an electrical switch or contact, a rise in temperature above a prescribed 
limit, etc. 
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INTERRUPT PRIORITY ^HEME 

There are se¥eral ways in which priorities are determined for or assigned to 
devices on the I/O bus. An elementary priority' is established by the hardware for 
devices that are requesting interrupts simultaneously: among those devices 
waiting with an active interrupt, the one which is physicaUy closest to the ^oc- 
essor on the bus is at the highest priority. 

The most significant method is to specify which devices can interrupt a servicing 
routine currently in progress. This is dooe by using a 16-bit priority mask. Each 
device is wired to a particular bit of this mask word. 

By means of the mask word, the interrupt servicing program can inhibit specified 
levels of interrupts and thus establish any priority structure. The biggest 
advantage of this means of priorit>^ level control is a near optimum priority response. 
To guarantee minimum response time to an interruf*, the mask bit assigned to 
this device should not be set for long periods of time. Through the judicious use 
of masking, data channels can he kept functioning for the transmission of data into 
and out of core storage while process interrupts are prevented from occurring. 
The function of masking is used to delay recognition of an interrupt (the important 
fact is that the interrupt is not lost). 

The interrupt mask assignments for standard devices supplied by DGC are as 
follows: 

Mask Assigned Devices 

3 $TTO, $TTI, QTY (4060 multiplexor) 

7 $PTP 

10 $LPT 

17 $PLT, MCA (4038 multiprocessor communications 
adapter transmitter /receiver). 

617 moving head disk 

717 fixed head disk 

1737 $PTR 

1777 $CDR, magnetic tape, cassette 

Although slower devices are assigned to higher numbered bits in the mask, there is 
no established priority, since the program can use any mask configuration. All 
devices which have their mask bits set cannot cause an interrupt and are therefore 

regarded by the program as being of lower priority. 
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IhTERRUPT PRIORITY ^HEME (CoEtinued) 

An example of multi-le^el priority interrup servicing is shown below for an 
environment including a Teletyf«#*, line printer, and fixed head disk. 



Program 



Mask 



Fixed Head Disk Interrupt 717 



Plotter 



Teletype Interrupt 



Main Line User 



17 








INTERRUPT DISPATCH PROGRAM 

At the precise moment an unmasked interruprt: has been detected at the hardware 
level, the Interruf* Dispatch program (INTO) receives control to service the 
interruF*. The INTD program is assembled as an integral portion of the RTOS 
system and resides in core at all times. 

The INTD program is designed to do the fo Mowing: 



, Identify the interruf*ing device 
. Save the machine status and all 

addressable registers 
. Set up the new priority mask 



, Direct control to the proper servicing 
routine 

. Restore the previous priority mask 

. Restore the machine status and reg- 
isters 

. Return to the interrupted program 



The INTD program directs control to the correct servicing routine by using the 
correct entry in the system Interrupt Branch Table (ITBL). The entry in this table 

is to a Device Control Table (DCT) associated with the servicing routine for the 

device. 



♦Teletype is a registered trademark of Teletype Corporation, Skokie, Illinois, 
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User ftrogram 



Interrupt 



ITBL 




INTS: 




Flow of Control IXirlng Interrupts 



DCT 



SAVE 



MASK 



INTS 



Interrupt 


7 -word 


Service 


State Save 


Routine 


Area 
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DEVICE CONTROL TABLE (IXIT) STRUCTURE 

Each de¥ice defined in the RTOS system must ha¥e the address of its I^T included 
in the interrupt branch table (ITBL) as explained in later sections. For interruf* 
ser¥icing routines defined in the user's area, only the first three entries are 
needed. For a thorough understanding of DCTs, a complete EXIT as used in an 
RTOS interruft servicing routine is described. 



Word 0, DCTSV: 



Word 0, 


IPCC 


Word i. 


lACO 


Word 2, 


lACl 


Word 3, 


IAC2 


Word 4, 


IAC3 


Word 5, 


ICMSK 


Word 6, 


IRLCX] 



Address of a seven-word interrupt state save area with the 
foEowing structure: 



PC and Carry 

AGO 

ACl 

AC2 

ACS 

Current Hardware Mask 

Contents of system page zero temporary 



Mask Word. Set a bit for every priority considered lower than 
the priority of this device. The devices corresponding to the 
priority bits that are left cleared will be permitted to interrupt 
the current device. * A complete list of system masks is 
provided in INTERRUPT PRIORITY SCHEME. 



Word 2, DCTIS: Address of the device interrupt service routine. 

Word 3, DCTCH: Device characteristic word, A list of device characteristics is 
given in the table below. 



Word 1, DCTMS: 



MNEMONIC BIT 



DOCK) 

DCCGN 
DCIDI 

DCCNF 
DCTO 

DCKEY 
DCNAF 
DCRAT 

DcrcK 



IBIS 
1B14 
1B13 
1B12 
IBU 
IBIO 
1M)9 
1B08 
1B07 



MEANING 

Device requiring leader/trailer 

Device requiring tab simulation 

Buffered input device 

Device requiring form feed simulation 

Teletype output device 

Keylx)ard input device (uncontrollable) 

Device requiring 16 nuEs after form feeds 

Device requiring rubouts after tabs 

Device requiring even parity check on inputs 

parity computation on outpit 



even 



*A11 interruprs are disabled when the RTC is being serviced. 
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DEVICE CONTROL TABLE (DCT) STRUCTURE (Continued) 
MNEMONIC BIT MEANING 



DC LAC 

DCPFR 

DCFWD 

I^FFO 

DCLTU 

DCC80 



iro6 

IMS 
1M4 
1B03 
1B02 

iroi 



De¥ice requiring line feeds after carriage returns 

Auto restart mode bit (internal to RTOS) 

Full word de¥ice (any size greater than a byte) 

Form feed sent on . OPEN 

Convert lower to up^r case ASCII 

80 column device (suppress line output after 80 

columns) 



Word 4, DCTCD: Device Code. 

Word 5, IXUTEX: Address of variable I/O Instruction routine. 



Word 6, IX^TDT: 



Address of the device command dispatch table. One entry for 
every RTOS I/O function. The table order must correspond 
exactly to the order of the functions given below. Each entry 
is an address to the routine implementing the named RTOS 
function. If the device does not permit a command, a -1 should 
be entered in place of the address. 



MNEMONIC 


DISPLACEMENT' 


MEANING 


OF 





Op«n a file 


CF 


1 


Close a file 


RS 


2 


Read Sequential 


RL 


3 


Read Line 


WS 


4 


Write Sequential 


WL 


5 


Write Line 


RB 


6 


Read Block 


WB 


7 


Write Block 


OA 


10 


Open a file for appending 



Word 7, DCTST: 



Address of the device start routine, 
specification is as follows: 



The Device Start Routine 



Input device: 

Output device: 



Activate the device and return 

STOUT or address within the device handler; 

performs the equivalent of an interrupt 

service. 
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DEVICE COMTROL TABLE (DCT) STRUCTORE (Continued) 

Word 10, IX]TIN: I^vice initialization routine. 

Word 11, I^TLK: Link to start of TCB queue comf^ting for a device. 

Word 12, DCTTO: Timeout constant (none if zero). 

Word 13, IX]TQL: Link in device request bead chain. 

(Word 13, DCTD2: First displacement of DCT for mag tape or cassette unit; 

see discri|*ion at end of this section. ) 

Word 14, IX]TDP: Device byte data ix)inter. 

Word 15, DCTIX^: I^vice byte count. 

Word 16, DCTQS: Bead status word (descrited in GENERALIZED I/O ROUTINES). 

Word 17, EKZITBD: Bead address (i. e. , the starting address of the bead, words 

13-16). 

Word 20, DGTQP: Request bead queue starting address (initially -1). 

Word 21, EOTOC: Characteristics of 0|^ned device. 

Word 22, DCTTl: First tem|X)rary for device controL 

Word 23, DCTT2: Second temporary for device controL 

Word 24, IXITCT: Current timeout count ( input device). 

(Word 24, IX3TCC: Output device column counter. ) 

Word 25, DCTPR: Echo device IX^T pair pointer, TTI only. 

(Word 25, IX^TLC: Output device line counter.) 

Word 26, DCTSC: Saved device request byte counter. When special characters 

not in the differ must be generated (e. g, , LF after CR), this 

word is used to save the current device ^te counter so that 
this character can be generated and transmitted. 

Word 27, IX:TGN: Character for generation (see word 26). 
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DEVICE CONTROL TABLE (DOT) STRUCTURE (Continued) 

The following displacements, 13-28, are used with magnetic tape and cassette 
units using buffered I/O, 

Word 13, UNUM: Device unit number. 

Word 14, ADUCT: Base address of tape unit control table (UCT). 

Word 15, DADR: Base address of data area. 

Word 16, IX] NT: Word or record count. 

Word 17, lOFRP: Pointer to I/O function routine for . MTDIO 

Word 18, CMDWD: Command word, ready for DOA. 

Word 19, TEMP: Temporary word used by RTOS. 

Word 20, OPRET: Temporary word used by RTOS. 

Word 21, .UCTX: Base address of currently initialized unit's UCT. 

Word 22, .ST: Address of "STATU" routine used to get magnetic tape unit 

status. 

Word 23, .ISSU: Address of "ISSUE" in module MTSER. 

Word 24, PFR: Bit - flag set to 1 when unit is positioning for retry 

Bits 1-15 - Counter used in attempting to erase for write retry. 

Word 25, RTCTR: Write counter. 

Word 26, MODE: I/O mode word; Line = 1, Sequential = 0. 



***** 
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CHAPTER 2 

OPERATING SYSTEM DEVICE DRIVER IMPLEMENTATION 
GENERAL 

There are two major approaches to implementing a device handler in RTOS. The 
first, and probably the most commonly selected choice, is to minimize the interface 
between RTOS and the new driver by providing only a three -word DCT header and 
issuing RTOS system call .IDEF. This defines the device to be a special user 
device, and information in the three- word DCT permits the user service routine 
to obtain control from the interrupt dispatcher at the right times. 

The second choice is to integrate the new device handler into the main body of the 
operating system, thus taking advantage of the system's general pirt^se I/O 
facilities. This second choice requires a system level knowledge of RTOS. A 
driver implemented in this way will be able to use standard system calls, e.g. , 
.OPEN, .CLOSE, .RDS, etc. 

At key points in RTOS system call processing, the flow of control may be intercepted 
in order to make provision for new devices. In particular, the name of a file 
submitted as input to the . OPEN call must be interpreted by a routine which can 
derive a physical device location from the name of the device. Also a software 
channel to that device must be established for references in read/write calls. The 
system must be rescheduled at the initiation of an I/O transfer and again at its 
completion. The section which follows discusses the interactions between device 
handler and system at these times. 

GENERALIZED I/O ROUTINES 

The I/O module (GENIO) provides a number of useful, general {wrpose routines 
for handling byte I/O from any device, on input or output, using the program 
interrup: facility. Entry names of the appropriate I/O routines are placed in each 
device driver dispatch table as required (see I^vice Control Table Structure, 
word 6). GENIO also provides 3 routines used by RTOS to implement system 
calls .GCHAR,^ . TCHAR, and .RESET. These calls are discussed in the RTOS 
Reference Manual, 093-000056. 

¥to system buffering of data is performed* under RTOS. Instead, data is transferred 
between a device and a user area, with pointers and counters maintained to mdicate 
the amount of data in the area and the current word input or output. A four-word 
bead is assigned to maintain status information and i»lnters for each user area. 

*Two exceptions to this rule are the $PTR and the $CDR. A 10-byte taffer is main- 
tained for the $PTR to prevent chatter, and an SO-word buffer is maintained for 
the $CDR to permit the transfer of all 80 columns from a card. 
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GENERALIZED I/'O ROUTIXES (Continued) 

While processing efficiency is gained by this direct transfer of data tetweeii pro- 
gram a.iid device, the timing of device activity is more rigidly synchronized with 
the issuance of system calls. 

The following illustration is similar to its counterpart in RDOS. The primary 
difference between this illustration and that given for tead structure in RDOS is 
that the data area governed by an RDOS bead is actually a system buffer which 
resides in the device handler. By contrast, RTOS deals directly with the user area, 

An input device under RTOS inputs to the user area at interrupt time and an output 
device outputs from the user area at interrupt time. 





rDP 



DC 



Input Etevices 



Output Devices 



Pointer DP indicates the current slot in the user area which is targeted for storage 
or retrieval of data by the device. Counter DC indicates the number of slots in the 
area which remain to be processed. 

miien DC becomes equal to zero, or when the completion of the request represented 
by a bead is otherwise indicated, the interrupt service routine checks to see if a 
user task needs to be readied. This is the case if a one is found in bit zero of the 
bead status word. Otherwise, bit 15 of the tead status word is set to one, Indicating 

completion of I/O. In either case, the bead is removed from the queue. 

A virtually unlimited number of user areas can be appended to the first area, pro- 
viding the facility for unformatted stream I/O and substantially reducing system 
overhead. Nonetheless, current versions of RTOS employ no more than one bead 
outside the main DCT bead. The DCT bead itself is used for user task I/O. 
Additional I/O buffers are appended to the first buffer by linking or stringing 
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GENERALIZED I/O ROUTINES (Contmued) 

additional beads to the first bead. Each bead has a link to the next bead in the 
string; the terminating tead has a -1 link. lOSEE provides routines to add beads 
to a string. Beads are removed from the string when data transfers are complete. 

One bead consists of words 13 through 16 of the device's DOT, The structure of 
each tead is as follows: 

Displacement Mnemonic Contents 

RQLK Link Word 

1 RQPTR Byte Pointer (DP) 

2 RQCNT Byte Count (DC) 

3 RQST Bead Status Word 

Successive beads used by the system for purposes like echoing are linked to by 
previous bead links. The first bead in the string is pointed to by DCTQP of the 
device's DCT. 

Bit of the bead status word is set to 1 if this bead is imbedded in the device's DCT 
(words 13 - 16). Bit is reset if the bead is outside the device's DCT. The DCT 
tead is employed for user task I/O, and upon the successful emptying (or filling) 
of the data buffer, the task is readied and returned to the normal return of its 
system call. The non-DCT bead is used by RTOS for echoing data to the console. 
In the event that data is being written to $TTO and keyboard characters are also 
received, the keyboard characters are placed in a buffer whose bead is placed 
ahead of the $TTO DCT bead. 

Bit 1 of the tead status word is reset to if the I/O operation requires byte calcula- 
tion to be transmitted in ACl (as in . WRL, . RDS etc. ). Bit 1 is set to 1 if no 
byte calculation is to be performed and the task's original ACl is to be preserved. 
This occurs with such system calls as .OPEN (form feed or leader), .CLOSE 
(form feed or trailer), . PCHAR etc. 

The meaning of bit 15 depends upon the setting of bit 1. If bit 1 is set to 1, then 
bit 15 set to 1 indicates a line mode I/O operation, and bit 15 set to Indicates 

sequential I/O, If bit 1 is cleared, bit 15 set to indicates the I/O request is not 
done, while bit 15 set to 1 indicates the I/O is complete. (The ENQUE routine, 

discussed later, clears bit 15 for all non-DCT teads. ) 
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GENERALIZED I/O ROUTINES (Continued) 



DOT 




Bead 



-1 



DPn 



DCn 



STATUS 




A brief description of the major routines in GENIO follows. More detailed informa- 
tion can be obtained by reviewing the listing of GENIO. Before discussing specific 
I/O routines, the following observations must be made about all I/O routines whose 
entries are used in DCT device dispatch tables. 

System I/O routines are not called in the conventional sense. Rather, the names of 
those routines which are required by a device driver are inserted into the appropriate 
displacements of that driver's dls|Mtch table. This table is a nine-word table with 
the following definitions: 



Displacement 


Mnemonic 


Command Function 





OF 


open a device 


1 


CF 


close a device 


2 


RS 


read sequential 


3 


RL 


read line 


4 


WS 


write sequential 


5 


WL 


write line 


6 


RB 


read block 


7 


WB 


write block 


10 


OA 


open a device for appending 
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GENERALIZED I/O ROUTINES (Continued) 

Control is passed by the system to the routine pointed to in the dispatch table at a 
time when, after ha¥ing waited in a queue for a device, the calling task has 
exclusive access to the device. Execution takes place at base level in the system. 
That is, all interrupt levels are enabled and their ^service has priorit}^ over these 
routines. As far as routines in the GENIO module are concerned, the device is 
idle and is awaiting the initiation of I/O. In actuality, the device may still te in 
operation, if it is one of those devices whose interrupt service routine provides 
its own buffering. 

The actual function of the . . RDS, . . RDL, . , WRS and , . WRL routines is to 
initiate an I/O transfer in the appropriate mode by constructing a bead and then by 
placing it in a device queue. If a device's characteristics word sfKcifies the need 
for special output (e. g. , leader, trailer, etc.), the .CLSI and .CLSO routines 
initiate this I/O via beads. Read and write block entries are found in the disk DCTs 
for interrupt handling purposes and then issue the initial series of commands to the 
disk controller. If no I/O is initiated, the routines exit to the lOEND processor 
at base level; otherwise, control goes to the scheduler. 

Command functions which are to be unavailable to a device are indicated by the 
placing of a -1 in the appropriate tabl^ offset location. An attempt to perform 
this forbidden command function would result in error code ERICD (illegal 
command for device) being issued. It is conceivable that a special I/O function 
might need to be written (e.g. , a special read line, RDLl) and that the entry for 
this routine might be inserted into the table (e. g. , at displacement 3). Special 
considerations for the writing of such customized routines are given at the end of 
this section. Along with a description of each of the standard GENIO routines there 
is given a list of input which is provided by the system when each of these routines 
receives control. In some cases, not all of these inputs are utilized by the routines; 
the complete list does indicate, however, m^hat inputs are available should a 
customized routine in this command table displacement be written. 

Open a Device (.OPNO, .OPNI) 

.OPNO is used to open output devices, while .OPNI is used to o|«n input devices, 

.OPNO provides a form feed and outputs leader if required. These routines pre- 
sume that the DCT has provided space for all necessary I/O buffer information as 
well as the link to queued tasks awaiting I/O, the timeout constant, and temporaries 
for device control (words 11-20 and 22, 23 of DCT). 

System inputs: ACl - characteristic inhibit mask 

AC 2 - DCT address 
ACS - TCB address 
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Open a Device {, OPNQ, , QPNI) (Continued) 

Calling sequence: Insert .OPNO (. 0PM) mnemonic into the de¥ice dispatch table, 

displacement OF. 

Close a I^¥ice (.CLSO, .CLSI) 

.CLSO closes an output device, and punches trailer if required, .CLSI clears the 
device and initializes the handler, and then resets the bead queue (by setting the 
tead queue pointer to -1). A special check is made for keyboard devices, which 
axe not cleared, etc. , since they might be in the process of echoing information. 
Both ,CLSO and .CLSI branch to the I/O end processor (lOEND) at base level; this 
module will be described at the end of this section. 

System inputs: AC 2 - DCT address 

AC3 - TCB address 

(displacement TAC3 of TCB contains a pointer to the UFPT 
frame for the channel being closed) 

Calling sequence: Insert .CLSO (.CLSI) mnemonic into the device dispatch 

table, displacement CF. 

Read Sequential (. . RDS) 

This command function causes the device to he read, one byte at a time, until the 
b3fte count requested is satisfied. The data is not modified in any manner; this 
command is used for binary transfers. 

System inputs: ACO - destination byte pointer (byte address of area to 

receive the data) 
ACl - byte count 
AC 2 - DCT address 
AC3 - TCB address 

Calling sequence: Insert . . RDS mnemonic into the dispatch table, displacement 

RS. 

Read a Line (..RDL ) 

This routine is used to read ASCII data from a device and transmit this data to a 

user area. The transmission is terminated after detection of a carriage return, 
form feed, or null. All bytes are masked to seven bits. Line feeds are uncon- 
ditionally ignored. Checks of the device characteristics are made to determine 
whether to perform parity checks, whether the device is an 80-column device, etc. 
This interpretation of ASCII data is done by the interruf* service routine, 
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Read a Line (..RDL) (Continued) 

System inputs: AGO - byte pointer to data area 

AC2 - DCT address 
AC 3 - TCB address 

Calling sequence: Insert mnemonic , .RDL into the de¥ice dispatch table, 

displacement RL. 

Write Sequential (. . WRS ) 

This routine outputs binary data in byte form from a user area to a device. The 
data is not altered in any manner. This mode is therefore the standard mode for 
binary output transfers. 

System inputs: AGO - byte pointer to data area 

ACl - byte count 
AC 2 - ECT address 
AC3 - TCB address 

Calling sequence: Insert mnemonic . .WRS into the device dispatch table, 

displacement WS. 

Write a Line (..WRL) 

This routine transmits ASCII data to an output device and terminates transmission 
after sending either a carriage return or form feed. Termination also occurs upon 
detection of a nuE, but the null is not written. Interrupt service routines make 
checks of the device characteristics to determine whether to perform parity com- 
putation, tab simulation, etc. 

System inputs: ACO - byte pointer 

AC 2 - DCT address 
ACS - TCB address 

Calling sequence: Insert mnemonic , • WRL into the device dispatch table, 

displacement WL. 

Read and Write Disk Blocks 

Displacements RB and WB in each device dispatch table are reserved for entries 
to disk read/write block routines. These routines are found within the disk 
drivers proper, not in GENIO, Input parameters provided by the system upon 
entry to these routines are as follows: 
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Read and Write Disk Blocks (Continued) 

AGO - starting core address for tbe transfer 

ACl - starting relative disk block numter 

AC 2 - DCT address 

AC3 - TCB address 

Open a Device for Appending 

Since opening a device for appending is equivalent to simply opening the device, 
displacement OA in the device dispatch table is set with routine ,OPNO for those 
devices which permit appending. 

Writing a Custom I/O Routine 

If the I/O routines described in this section are inadequate, special routines may be 
written and their entries can be inserted appropriately into a device dispatch table. 
Before this project is undertaken, detailed study of RTOS listings, especially 
SYSTEM, lOSER, and GENIO should be made. The following discussion is pre- 
sented as an introduction to such a study. 

The above discussions of GENIO routines indicate what inputs are provided by the 
system for each type of call. It remains to be seen how control exits from these 
routines, so that similar exits could be made from custom I/O routines. 

Exit from generalized routines occurs in one of two ways, depending upon whether 
or not the routines expect further interrupts to be generated. If further interrupts 
are anticipated, the following sequence occurs. First, the bead status word is set 
up, as are the byte pointer (DC TDP) and the byte count (DCTDC); line mode opera- 
tions set DCTDC to 077777. The bead address, DCTBD, is then loaded into ACl; 
the scheduler address SCHED is loaded intD AC3 and interrupts are disabled. 
Control is then dispatched to ENQUE to enqueue a bead to the DCT, after which 
control is dispatched to the task scheduler. 

If further interrupts are not anticipate as the immediate consequence of the call, 
AC2 is set to the address of the DCT, and an unconditional transfer to , lOEND is 
made. 

If no task is awaiting the use of this device, the current task is readied and return 
is made to the scheduler (SCHED) if .lOEND was entered at base level. Otherwise, 
control goes to the interrupt dismissal routine (DISMISS), Rescheduling then occurs 
only if the system switch, . SYS, , Indicates that RTOS is not in the system mode. 
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Writing a Custom I/O Routine (Continued) 

If another task is awaiting the use of this de¥ice, pro¥ision is made to start the de- 
vice again and to ready the current task; control then returns either to the scheduler 
or to the dismissal routine as descrited above, 

DISMISS, location 11, contains the address of an entry, DISN, in the interrupt dis- 
patch module INTD. This routine is entered with the device DCT address in AC 2. 
The original hardware mask is restored. If dismissing to another interrupt servicing 
routine, interrupts are re -enabled and return is made to the interrupted routine. 
If dismissing to a user task, a rescheduling check is made. If no rescheduling is to 
occur, interrupts are re-enabled and return to the task is made. Otherwise, the 
state of the interrupted task is saved in its 'TCB and the scheduler is entered. 

Opening a User File 

The system call , OPEN uses the file name supplied as an argument to identify the 
device to which subsequent I/O operations will be directed. If channel-oriented 
I/O calls are to be usable with a new device, there must be a way for the . OPEN 
routine to trace each file name to the DCT for that device, e.g. , $FTR for the paper 
tape reader. A more complex file name construction is necessary if the device 
consists of multiple communication lines or circuits, channels or units, or if the 
device is a storage medium with compartmentalized data. 

During the processing of a .OPEN call, a series of attempts is made to match the 
file name with entries in tables built at RTOSGEN time. Without modifying either 
the RTOSGEN program or the resident RTOS . OPEN logic, the user may add a 
routine to recognize file names for new devices. After the RTOS routine has tried 
and failed to recognize a file name, it will pass control to a user routine with the 
entry label . CKUS, provided that such an entry was defined at relocatable load 
time. 

The . CKUS routine may then check for other forms of device specification and, if 
successful, locate the corresponding control blocks for opening the channel. Having 
opened the channel, the user returns control to entry . FOPN which finishes the 
, OPEN process. This includes calling the routine found in the dispatch table 
pointed to by displacement IX^TDT of the DCT. 

When control arrives at .CKUS, ACS contains a return address which is to be used 
only if the file name is not recognized. The system ensures that page zero location 
CTCB contains the address of the caller's TCB. Displacement TAC3 of the caller's 
TCB contains the address of a two-word block which must he set up to open the soft- 
ware channel. The . CKUS routine must place the appropriate DCT address in the 
first word of this pair. The second word of the pair is optionally available for a 
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Ol^ning 3 User File (Contimieci) 

pjinter to a contro- '-lock for a unit, circuit, etc. , within the deYice. This word 
pair is called a :isijr file p) inter table (UFFT) entry. On completion, if the file 
name was recognized, the . CKUS routine must branch to entry . FOPN in RTOS 
with the DCT address in AC3, If the file name was not recognized, control must 
be returned to the address input in AC3 uron entry to . CKUS. This will cause re- 
jection of the file name and an error return for the caller (error code ERDLE: 
non-existent file). 

I/O SERVICE MODULE (lOSER) 

The lOSER module is used by system drivers generally for byte-orietited dcYices, 
One use of lOSER is to execute certain types of I/O instructions; this permits the 
writing of reentrant drivers used by multiple devices (e. g. , a multiple TTY system 
requiring only one TTY driver). Another use of lOSER is to provide common input/ 
output character device interrupt processing. lOSER also provides routines to 
place a bead at the end of a bead string, and to priority enqueue a tead at the head 
of the queue. 

The following list summarizes the entries in lOSER: 

Entry Use 

.CLOSE Common output interrupt service. 

. STOU Start an output device. 

• ENQB Add a bead to the end of a string. 

.PENQ Priority enqueue a bead at the head of a string. 

,FINP Common input interrupt service. 

. , lAC DIAC instruction processor, 

.DIAS DIAS instruction processor. 

,DOAS DOAS instruction processor. 

,NIOC NIOC instruction processor, 

.NIOS NIOS instruction processor, 

.SKPB SKPBZ instruction processor. 

Calls to any of the instruction processor entries cause that instruction to be built 
(for the si^cific device in question), stored in the driver's "execute I/O instruction" 
area (pointed to by DCTEX of the device's DCT), and executed. Control is then 
returned to the caller. Calls to the instruction processors are issued solely by 
the system; specific call types defend upon the entries selected in the device dis- 
patch table or in displacement DCTST of the I^vice Control Table. 
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Common Output De¥ice Interrupt Service (.COSE, .STOU) 

.COSE clears a character device and then pro¥icles interrupt ser\dce for the device, 
. STOU provides the equi¥aleiit of interrupt service for the purpose of starting a 
device. Each routine can be called either by placing its mnemonic in word 2 
(IX]TIS) of the DCT or by means of the following calling sequence: 

Input: AC 2 - I^T address 

ACS -• return address 

Calling sequence: . EXTN .COSE (.STOU) 

JSR i COSE 
return to DISMISS 

COSE: .COSE (.STOU) 

Function: Line mode editing is f^rformed in accordance with the device's 

characteristic word, DCTCH, of its device control table. 
Specifically, the following functions can be performed: lower- 
case ASCII is converted to uppercase (DCLTU), tabs are 
simulated (DCCGN), a rubout is inserted after each tab 
(DCNAF), the line output is truncated by suppressing output 
after 80 columns (DCC80), and parity computation is performed 
(DCPCK). AC2 is preserved upon exit. 

Add a tead to the String (.ENQB) 

.ENQB attaches a tead to a device. This tead becomes the last bead in the string, 

and is given a LINK of -1. . ENQB is called by means of the following calling 

sequence: 

Input: ACl - Bead address 

AC 2 - DCT address 

Calling sequence: .EXTN .ENQB 

JSR i ENQ 
return 

ENQ: .ENQB 

Function: The bead is attached to the device. The device is started if it 

was formerly idle. AC 2 is restored upon exit. 
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Insert a tead at the Start of a String (.PENQ) 

.PENQ attaches a bead to the front of the tead queue. This routine is used 
principally for echoing characters to an output device, , PENQ is called by means 
of the following calling sequence: 



Input: 



ACl - Bead address 
AC 2 - DCT address 



Calling sequence: 



.EXTN .PENQ 
JSR i PENQ 
return 



Function: 



PENQ: .PENQ 

The DCT tead (with its associated buffer) is placed before aU 
other beads in the string. AC 2 remains unchanged upon exit. 



Common Input Device Interrupt Service (.FINP) 

.FINP provides interrupt service to input character devices. .FINP is called by 
means of the following calling sequence: 



Input: 



ACO - input character 

AC 2 - DCT address 

AC 3 - return address (DISMISS or lOEND) 



Calling sequence: 



.EXTN .FINP 

JSR @ FINP 

return to DISMISS or lOEND 



FINP: .FINP 



Output: 



For line mode transfers, a parity check is performed and the 
input character is examined to see if it is an end-of-file 
(CTRL Z); if so, the line is terminated without storing the 
CTRL Z. Exit character checks are then made, and if a 
rubout or \ is detected, either the last input character is 
deleted or the entire line is deleted. Line feeds are ignored, 
A check is made for carriage return, form feed, or null 
terminators. Non- keyboard devices cause rulx)ut characters 
simply to be ignored. For sequential mode, the byte is stored 
in the device buffer, and the number of bytes transmitted is 
calculated and returned to the task ACl. 
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I^claring the Device Name and DOT Address 

The names of user devices and the addresses of their DCTs are declared when the 
RTOS module, output by RTOSGEN, is created. Declaration of the DCT names of 
user devices is accomplished by responding in the affirmative to question 19 of 
RTOSGEN: "USER SUPPLIED DRIVERS?". By striking "1" on the console keytoard, 
you trigger the further pair of questions: 

DEVICE CODE? 
NAME? 

Respond with the octal device code for the first user device, and follow this with 
a carriage return. Then input a 3 alphanumeric character name for the device, 
and follow this with a carriage return. The pair of questions is re|»ated for more 
devices. Respond with a simple carriage return to the device cx)de query to 
terminate this interrogation. As described in Appendix B of the RT(B Reference 
Manual, 093-000056, RTOS then outputs a complete list of system and user device 
codes, DCT names (which are simply the device names with a EXJ suffix), and 
device names. RTOS will place table entries for all user devices into .ITBL; each 
table entry will contain the address of that device's DCT. 

Corresponding to the RTOSGEN declaration of user device names, each user device 
driver must have an entry with the same DCT name as that specified to RTOSGEN. 
That is, if the device name was specified to be ABC, the driver for this device 
must contain an entry to the device's DCT: . ENT ABCDC. 

High Priority Interrupt Devices 

High priority interrupt devices are devices which will receive interrupt service 
control before standard devices. System high priority devices are the real time 
clock and the power fail/auto restart option. Question 18 of RTOSGEN permits 

special user devices to also receive high priority interruprt: service. 

In essence, the operation of the high priority interrupt dispatcher, .HINT, is as 

follows. Each high priority interrupt device is examined to see if it generated 
the interrupt. The power fail monitor is tested first, then the real time clock, 

and then each of the other user devices specified at RTOSGEN time in the order 
that they were specified during system generation. If the source of the interrupt is 
found, control is dispatched to its interrupt service routiw; otherwise, control 

is given to the ordinary interrupt dispatcher. 
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High Priority hiternipt De¥ices (Conttniied) 

ITie name given in response to question 18 for each user high priority device witfi 
the suffix IS added becomes tiie name of the entry point to the service routme for 
each such device. Thus if tiie name given for one high priority user device was 
GHK, the entry point to tfiis device's interrupt service routine would be GIKB, 
and tills address would have been entered in die service routine: . ENT GHKB. 
For information describing the writing of high priority user interrupt service 
routines, see Chapter 3, HIGH PRIORITY INTERRUPT SERVICE . 

Loading a User Driver 

After specifying ail user drivers at RTOSGEN time and assembling these drivers, 
they may be loaded with user relocatable binaries and the RTOS libraries. Etepend- 
ing upon the loader used, one of several relocatable load procedures can be 
followed. These procedures are descrited in Appendix B of the RTOS Reference 

Manual . In essence, RTOS.RB, user driver relocatable binaries, and " 

the user program binaries must be loaded before the RTOS libraries. Consult 
the RTOS Reference Manual for more details. 

RTOS System Library List 

The following Hst names and describes each of the library modules contained in the 
RTOS libraries for revision 4. 00 of RTOS, run on both the NOVA and ECLIPSE 
computers. 



Relocatable Binary Title 
BFPKG 

TXMT 
TAG ALL 
TABOR 
TSKID 

TMIN 

TCBMON 

TUMOD 

TQTAS 

TIDSR 



Function(s) 

Core Buffer I/O package (see 017-000003). 

.XMT, .REG, .XMTW, .IXMT logic. 

.AKILL, .SUSP, .ASUSP, .ARDY logic. 

. ABORT logic. 

.IDST, .TIDS, .TIDR, .TIDK, .TIDP logic. 

System call set up logic for single task programs. 
Single task environment task scheduler. 

System call set up logic for multitask programs. 
Multitask environment task scheduler. 

.SMSK, .UCEX, .UPEX, .UIEX logic, 

.QTSK, .DQTSK logic. 

Additional support for . QTSK/. IX^TSK. 
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RTOS System Library List (Continued) 
Relocatable Binary Title Function (s) 

SYSTEM 



INTO 
RTLN 

IDEB 

TTYID 

TTY2D 

TTYDR 

PTRID 

PTRDR 

PTPID 

PTPDR 

RTCDR 

CDRID 
CDRDR 
LPTID 

LPTDR 
PLTID 



System call processor and error handler. End 
of I/O processor. 

Interrupt processor. Interrupt dispatching and 
dismissal. 

Initializes system device DCTs. Resets system 
state variables. Initializes TCB pool and chains. 
Branches to user starting address. 

RTOS debugger (see 093-000044). 

Second Teletype driver. 

Third Teletype driver. 

Teletype driver. 

Second paper tape reader driver. 

Paper tape reader driver. 

Second paper tape punch driver. 

Paper tape punch driver. 

Time of day clock calls. Get RTC frequency. 
Set up user clock. Remove user clock. Clock 

delay system call. 

Second card reader driver. 
Card reader driver. 
Second line printer driver. 
Line printer driver. 
Second plotter driver. 
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RTOS System Library List (Continual) 
Relocatable Binary Title Function (s) 

PLTDR Plotter driver. 



QTYDR 
MCADR 
PWRDR 
GEiNIO 

lOSER 

CNVRT 
DSKDR 

DKPDR 

MTUO through MTU7 

MTBUF 
MTADR 

MTSER 



SMTU 



CTUO through CTU7 



CASDR 



4060 data communications multiplexor, 

4038 multiprocessor communications adapter. 

Power monitor /automatic restart. 

Generalized routines corresponding to system 
I/O calls (except .RDB/.WRB). 

I/O service routines, mostly interrupt level. 

Hollerith card code to 7 -bit ASCII converter. 
Fixed head disk drive for controller 0. 

Moving head disk drive for controller 0. 

Unit control tables (UCTs) and buffers for line 
and sequential I/O on magnetic tape units 
through 7, 

Read /write line /sequential I/O instruction 
support for magnetic tape and cassette units. 

Seven or nine -track magnetic tape device 
driver for controller 0. 

Magnetic tape/cassette interrupt service 
module. 

Truncated magnetic tape unit control tables for 
units MTO through MT7 employing non-buffered 
tape I/O. 

Unit control tables (UCTs) and buffers for line 
and sequential I/O on cassette units through 

7. 

Cassette device driver for controller 0. 
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PRACTICAL HIKTS FOR SYSTEM DEVICE DRIVER IMPLEMENTATION 

Elements in I/O Routines 

The following illustration lists the RDL routine, found in GEMO, as an example 
of the required elements in an I/O routine. 



EXTN .ENQB 

ENT ..RDL 

READ LINE SUBROUTINE 

INPUT: AGO: BYTE POLNTER 
AC2: DCT ADDRESS 
AC3: TCB ADDRESS 



RDL: LDA 1 LLIM 
MOVO 1 1 
JMP RDSO 

LLIM: 132 



PICK UP MAX BYTE COUNT 

SET CARRY FOR ASCII LINE MODE 

GO TO COMMON RDL/RDS CODE 



RDSO: SUBCL 3 3 
ADDOR 3 3 

SBEAD: STA DCTDP 
STA 1 DCTDC 2 
STA 3 DCTQS 2 
LDA 1 DCTBD2 
LDA 3 SCHED 
IN^TDS 
JMP t .ENQU 

.ENQU: .ENQB 



LOAD CARRY 

SET BIT FOR MAIN BEAD 
SET UP BEAD FOR REQUEST 
SET REQUEST BYTE POINTER 
SET REQUEST BYTE COUNT 

SET BEAD STATUS/MODE WORD 
LOAD BEAD ADDRESS FOR 
RETURN TO SCHEDULER 

ENQUE THIS BEAD, STARTING 

DEVICE IF NECESSARY. ENQUE 
WILL TRANSFER TO SCHEDULER 

WHICH WILL REENABLE INT'ERRUPT. 
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Examinatioii of a System Device Driver 

This section is devoted to a line -by -line examination of an actual RIDS 

driver, flie high speed paper tape punch driver (PTPDR). Also, to highlight tiieir 

similarities, the second paper tape punch driver is also illusttated. 

Following are the first 10 lines of the RTOS paper tape punch driver: 



B^Bl PTPOR HACRO REV P2 15502153 81/16/74 

0? IREAL TIHE 0PE»ATING SVSTEM fRTOS) 

•Till PTPpP I PT^S PAPER TAPE PUNCH DRIVER 

ms .ENT PTPOC .PPDT ,PP5V ,PP¥.% ,PPIN 

^7 

08 ,I.XTN ,0PNO .CLSO ..MRS ..WRL ICONMAND ENABLE 

919 ,EXTN .STOU ,NfOC ,CQSP 

li 



Entry PTPDC on line 6 defines the paper tape punch Device Control Table (DCT) 
starting address. . PPDT, . PKV, . PPEX, and . PPM define the punch dispatch taHe 
address, state save area, execute -I/O instruction routine, and punch initialization 
routine respectively, .PPDT, .PKV, .PPEX and .PPM are aE ENTered so that tiie 
second paper tape punch driver, PTPID, may reference these entries. .OPNO, 
.CLSO, ..WRS, and ..WRL are externally referenced since they define the system 
I/O command types v/hich can be issued to the punch. . STOU and . COSE, entries 
In lOSER, will be requirai to start the punch and provide output device interrupt 
service. 
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II 
18 
i3 
14 
15 
l« 
17 
IS 
19 

m 

23 

7J 

38 
39 

31 
3? 
3a 
34 
3& 



Examination of a System Deyice Driver (Continued) 

I PAPiR TAPE PUNCH OEVlCf CONTWOt TIRLE 



»li«P04 

^C4013 
PMei4 

^01517 
#««t4 



i^Pii^ig34 » 

177777 

W017«l 

i«^^pi43» 
177777 

iC^0»i3» 
\77777 



,PP6V ISAVE 

mkptp I mask 

,CnSE ICOMHON 

nf.»AT + ncCP1*nCPCK'i'0CLAC*DCNAF 
PTP 



MACNiNfe STATt 



.f^PtX 
.PPOT 
,STDI! 

.PPIN 

.-4 

-1 

• ei-X 



OUTPUT INTERRUPT SEP 
I CHAKACTtPISTICS 

lOfviCE cone 

IfclfcCiJTt. 

I DISPATCH TAPLf-. ADO«itSS 

I PUNCH START PPUTlN? 

IDEVICE INIT 
ITCB LINK 
ITINEOUT CONSTANT 
IBEADI LINK 

IDEVICE DATA BYTE POlNTtR 
IDEVICE riATA COUNT 
ISTATUS WORO • PPIHAPY BEAD 
IBEAO ADDRESS 
IDEVICE REQUEST CHAIN 
IQPENEP DEVICE CHARACTERISTICS 
IDEVICE TEHPS 
IN ISC. 



Relocatable locations through 24 (lines 16-35) comprise the paper tape punch 
DCT. Ihe indirect bit is set in the starting address of the DCT (line 15) to indicate 
that the punch is a system device having a more or less standard DCT. . PKV is 
the start of the state save area (reserved later on). Word 1 (line 17) defines the 

paper tape interrupt mask. This mask, 7, prevents all devices with mask bit 
assignments 13 through 15 from interrupting the punch. Word 2 specifies tihat 
punch interrupt service is performed by . COSE, the common output interrupt 
routine. Word 3, the device characteristics word, specifies that the punch has 
the following characteristics: rubouts must be sent after tabs, the device requires 
leader and trailer, a parity computation is required, line feeds must be issued 
after carriage returns, and nulls must be sent after form feeds. FTP, word 4 
(line 20), defines the punch device code to be 13. 

Word 5 (line 21) defines the start of the punch I/O execution area. Thus m^hen such 
instructions as "NIOS device " (see lOSER) are built for the punch, they are de|X>sited 
in relative location 30 and control is then transferral to Aem. . PPDT, line 22, 
defines the start of the punch dispatch table. ,SIBU, line 23, is the entry in lOSER 
used to start the punch, .PPIN, line 24, is the address of the punch initialization 
routine (we will see that no initialization is really performed for the punch). 
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Examination of a System Deylce Driver (Continueci) 

Word 11 is reserYed for the link to the queue of tesks awaiting use of the punch. 
The zero in word 12 prevents monitoring of the device for timeouts. 

Words 13 through 16 reserve the first bead of the punch driver; bit zero of the 
status word is set to indicate that this is the primary bead. Word 17, line 31, 
is a pointer to the primary bead. Word 20 (line 32) ix)ints to ihe current tead in 
the queue. Word 21 contains the current device characteristics word (which will 
differ from word 3 if some device characteristics are suppressed upon being opened). 
Words 22 and 23 are used by the interrupt service routine. The last block of mis- 
cellaneous tem|X)raries is used for starring such variaWes as the output line count. 



3b 

39 00i32».^0l401 JNP 1,3 

41 0«ti33»0Ml4i^0 .PPINI JNP C^ 3 



Location . PPEX receives I/O instructions built for the punch during the course of its 
operation. After receiving an instruction, , PPEX is called, the instruction is 
executed, and then control returns to the caller via word 31 or 32 (depending upon 
whether or not the instruction performed a skip). 

. PPIN, the initialization routine, merely returns control to the caller. (There is no 
initialization necessary for the punch. ) 
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Ejcammation of a System De¥ice Dri¥er (Coiitinued) 



nt 



PTPDR 



m 

m 
as 

019 

11 

14 



ifiS^iflPpia? .ppsvi .nm 7 iintfp«upt sf«vice save state 

DEFINE TN£ PIPER TAPF PUNCH DISPATCH TABLE 



PiP44 
P0i45 
PCTP46 
RPIW47 



I 



177777 .PPDTJ .OPNO 

177777 .CLSO 

177777 -I 

177777 -t 

177777 ,,w»S 

177777 ..'^^L 

177777 -I 

177777 -I 

pfflM043» ,PPNO 

,END 



PTP 
PTP 



PTP 
PTP 



OPEN 
CLOSE 



WRITE 
WKITE 



SfeQuENTIAL 
UNfc 



I PTP nPEN FOR APPENDING 



. PR5V defines the interrupt service state save area, . PPDT, the punch dispatch 
table, contains entries enabling tiie punch to be opened, closed, appended to and 
written to in both line and sequential modes. 

The cross index for PTPDR is given below: 



ir^P»3 PTPDR 










PTPOC 


iypi«i0' 


EN 


1/06 


1/15 




• CLSO 


VI^^-iS44 ' 


XN 


l/«8 


S/«7 




,COSE 


«00|^P2' 


¥N 


t/P'9 


1/19 




,NI0C 


177777 


¥N 


l/«9 






.OPNO 


000M53 


XN 


1/P8 


2 /MO 


2/14 


.PPDT 


0PW043 


EN 


l/«6 


1/22 


2/pe 


,PPE^ 


^iPii^SiJ 


EN 


1/^6 


1/21 


1/37 


,PPIN 


PBPi33 


' EN 


l/«6 


1/24 


1/41 


,PPSV 


i0e§'34 


' EN 


1/^6 


1/16 


2/P2 


.STOU 


0'aWvffl7 


' XN 


l/i9 


1/23 




,.«PL 


^ P P ffl 5 


» XN 


1/M8 


2/11 




,,to»S 


PP«^^47 


' ¥N 


l/Wd 


2/iw 
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Examinatioii of a System Device Driver (Continiieci) 

As can be seen by an examination of the DCT for a second paper tape punch, this 
DCT uses entries .PKV, .PPEX, .PPDT, and . PPIN defined earlier for the first 
punch. The device code for the second punch, word 4, is the only other difference 
between the first and second punch DCTs, Since the masks established for both 
punches are identical, one punch cannot interrupt the other and thus there is no 
conflict in their use of such portions of PTPDR as the state save area. 

PTPIO MACRO REV ^2 15JPt3;29 01/16/74 
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CHAPTER 3 

USER PROGRAM SERVICED INTERRUPTS 

SERVICING USER INTERRUPTS 

Special user devices may be identified either at the time an RTOS system is gener- 
ated (RTOSGEN time) or at run time. This chapter describes the procedure for 
identifying a user device at run time and for creating a user clock driven by the 
system real tim.e clock. Considerations applying to high priority interrupt routines 
are given at the end of this chapter. The considerations given for identifying a 
user device are common to both single and multitask environments; the user clock 
facility may also be used in both task environments. 

Upon detection of an interrupt request, the system will be dispatched through the 
device interrupt vector table, ,ITBL (see Chapter 1), In this table are pointers to 
Device Control Tables (DCTs) for devices established at RTOSGEN time, whether 
system or user devices. Chapter 1 describes titie structure of system DCTs. 

User Device Driver Implementation at Run Time 

In order to identify a user device to the system at run time, the user must provide 
a three -word DCT as an interface between the system interrupt dispatch routine 
and the user -interrupt servicing routine. ITie structure and mnemonic assignments 
of this three -word table are as follows: 

Displacement Mnemonic Purpose 

DCTSV Pointer to a 7 -word state save area. 

1 DCTMS Interrupt service mask. 

2 DCTIS Interrupt service routine address. 

DCreV is a pointer to a seven-word state variable save area usai by the system to 
save the PC, accumulators, carry, etc. of the interrupted task, DCTIS is a pointer 

to the routine which services this particular device interrupt. DCTMS is the 
interrupt mask* that the user wants to be ORed with the current interrupt mask 
while in the user interrupt service routine. This mask establishes which devices -- 
if any --will be able to interrupt the currently interrupting device. 



* See "How to Use the NOVA Computers", Section 2. 4. 
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User Device Driver Imple mentation at Run Time (Continued) 

Upon transferring control to the user interrupt service routine, the system wiU 
'ensure tfiat ACS contains the return address required for exit from the routine, 
and tiiat AC2 contems the address of the DCT upon exit from the routine, M 
revision 05 of RTOS, exit was accomplished by a jump to the return address 
specified by ACS up^n entry. In subsequent releases of RTOS, tesk caE . UIEX 
is issu«I, RescheduUng will occur immediately after the completion of Interrupt 
dismissaL 



All multitask environment activity ceases at the moment that a user device interrupt 
is detected. Nonetheless, it is possible for a user to communicate a message to 
a task from a service routine. If the task in question has been expecting such a 
message through issuance of a .REG and is now in the suspended state, issuance 
of the message via . IXMT will cause that task to be readied even though multitask 
activity is in abeyance. If no task has issued a .REC for such a message, .IXMT 
simply posts the message and takes no further action. For more information on 
communicating to tasks from a user interrupt service routine, see Chapter 3 of the 
RTC6 Reference Manual , 093-000056. 

Identifying User Interrupt Devices (. IDEF) 

In order to introduce to the system those devices (not identified at RTOSGEN time) 
whose interrupts the system is to recognize, the system call .IDEF must be issued. 

This call places an entry in the device interrupt vector table, . ITBL. Required 
inputs to this call are the device code of the user device and the starting address 
of this device's DCT. The format of this call is: 

AGO - Device code of the user device. 

ACl - Starting address of the user device's DCT. 

. SYSTM 
.IDEF 

error return 
normal return 

Possible error messages are: 

AC2 Mnemonic Meaning 

36 ERDNM Illegal device code (>77g). Device code 77g is re- 

served for the p)wer monitor/auto restart option. 
45 ERIBS Interrupt device code in use. 
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Exit from a User Interrupt Routine (.UIEX) 

Upon entering a user interrupt routine, ACS will contain the address required for 
exit from the routine. In all versions of RTOS, exit may be accomplished by a 
Jump to the return address specified by ACS ufx)n entry to the user routine. In 
reYision 3. 00 and later re¥isions, task call . UIEX can be issued to return from a 
user interrupt routine. 



The format of this call is: 

ACS - Return address. 

.UIEX 

Control returns to the location which was interrupted by the user device. No error 
return need be reserved. .UIEX can be issued in a single task environment. 

Remove User Interrupt Servicing Program (.IRMV) 

To prevent the system's recognition of user interrupts which have been previously 
identified by the .IDEF command, the .IRMV command is issued. Required input 
to this call is the user device code corresponding to the device control table which 
is to be removed. 

The format of this call is: 

AGO - Device code. 

. SYSTM 
.IRMV 
error return 
normal return 

One possible error message may he given, 

AC2 Mnemonic Meaning 

36 ERDNM Illegal device code (>77g) or attemf* to remove 

a system device (i, e. , one established at 
RTOSGEN time). 



3-3 



Licensed Material - Property of Data GeBcral Corporation 



Modifying the Current Interrupt Mask (.SMSK) 

RTOS contains a task call which f^rmlts the current interruf* mask to he 
modtfied. When a user iEterrup occurs, the interrupt service mask con- 
tained in DCTMS of the user de¥ice DCT is ORed with the current hardware 
mask. Nonetheless, it is possible to modify the current mask further by 
issuing task call . SMSK, The format of this call is as follows: 

ACl - New hardware mask to be ORed with the mask 

in effect before the current interrupt. 

AC 2 - DCT address 

.SMSK 
normal return 

There is no error return possible from this call. This call may be issued in a 
single task environment. 

WRITING USER POWER FAIL SERVICE 



RTOS provides software support for the power fail/automatic restart option. U|X)n 
detection of a |x>wer loss, the system transfers control to a power fail routine 
which saves the status of accumulators through 3, the PC and Carry. 

When power is restored, if the console key is in the LOCK position, the message 

**POWER FAIL** 

is output on the system console and the state variables are restored tefore control 
resumes operation at the |X)int where it was interrupted. If the console key was in 
the ON position when input power failed, the user must set the console switches 
to all zeroes (down) and START must be pressed when power is restored. This 
causes the console message to be output and state variables to be restored as when 
the key is in the LOCK position. 

The following system devices are given fX)wer-up restart service by RTOS: 

paper tape readers /punches 

Telet>^pes 

quad multiplexors 

card readers 

line printers 

disks 
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WRITING USER POWER FAIL SERVICE (Continued) 

Character de¥ices may lose one or more characters during power up. Each card 
reader may lose up to 80 columns of information on a single card. Line printers may 
lose up to a single Hue of informatioii. Since {»wer up ser¥ice for disks includes 
a complete re-read or re-write of the current disk block, no disk information, is 
lost, although mo¥ing head disk units will require 30 to 40 seconds before disk 
operations can continue. De¥ices requiring operator intervention (like line printers, 
card readers, etc, ) must receive such action if pom^er was lost for an extended 
I^riod of time. No power up service is provided for magnetic ta^ or cassette 
units. 

Power up service for special user devices (or for magnetic tape or cassette units) 
must be provided by the user via the system call .IDEF, The format of this call 
when used to Identify user power up service is as follows: 

AGO - 77g 

ACl - Starting address of user p^wer up ser\dce routine, 

. SYSTM 
.IDEF 

error return 
normal return 

The error return is never taken. 

Task call . UPEX is issued to provide exit from the user power- up routine. 

Exit from a Power Fail Service Routine (.UPEX) 

Task call . UPEX is issued to return from a user power- up service routine. The 
format of this call is: 

AC3 - Return address sf^cified in ACS upon entry to 

routine, 

.UPEX 
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Exit for a Power Fail Service Routine (.UPEX) (Continued) 

Control returns to the location which was interrupted by a power failure. No error 
return nor normal return need be reserved. .UffiX can te issued in a single task 
environment, 

USER PROGRAMMED CLOCK 



Two system commands, .DUCLK and .RUCLK, are available to permit the definition 
and removal of a user clock driven by the system's real time clock (RTC). This 
user clock interrupts multitask activity at user -definable Intervals. When one of 
these interruptions occurs, control goes to a user -specified routine outside the 
current single or multitask environment. No task calls (other than . IXMT) may he 
issued from this interrupt servicing routine. 

Define a User Clock (.DUCLK) 

This command permits tte definition of a user clock. When an interrupt is generated 
by this clock, the task scheduler and multitask environment- -if any- -are placed in 
suspension, and control goes to a user- specified routine. No system or task call 
(except . IXMT) may be issued from this user routine. The format of this call is: 

ACO - Integer number of RTC cycles during each 

clock interval. 
ACl - Address of user routine to receive control. 

. SYSTM 
.DUCLK 
error return 
normal return 

If the error return is taken, the following error code is issued: 

AC 2 Mnemonic Meaning 

45 ERIffi A user clock already exists. 

Upon a user clock interrupt, ACS will contain the address of the return upon entry 
to the user routine. Exit from the user clock routine is performed by issuing 
task call ,UCEX. Rescheduling always occurs. 
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Exit from a User Clock Routine (.UCEX) 



The format of the .UCEX call is: 



ACl - Zero only if rescheduling is to te suppressed. 

ACS - Return address upon entry to the clock routine. 

.UCEX 

Control returns to the point outside the user routine which was interrupted by the 
user clock. No errors are possible from this call. No error or normal return 
need be reserved. This call can be issued in a single task environment. 

Remove a User Clock (. RUCLK) 

This system command removes a previously defined user clock from the system. 
The format of this call is: 

. SYSTM 
.RUCLK 
error return 
normal return 

The error return must be reserved, but it is never taken, 

EXAMPLES OF USER SERVICED INTERRUPTS 

This section illustrates two implementations of user-written interrupt servicing 
programs for devices not incorporated into the system at RTOSGEN time. 

Analog to Digital Converter 

The first of the two illustration programs is an analog to digital converter driver, 
found on page 3-10, This driver consists of four subroutines which can be called 

from a user program, the interrupt servicing subroutine, and a Device Control 
Table. The following is a line by line analysis of the A/D driver. 

Lines 6-11 show that the title of the driver is AIDEV, that four entry points exist 

for user access of this driver, and that the driver program is normal relocatable 
(i. e. , that it does not use any page zero locations). Line 16 gives the address of 
the Device Control Table which is defined in lines 18-20. This is an abbreviated 

I3CT as discussed earlier. 
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Analog to Digital Converter (Continued) 

The first location in the DCT (line 18) |»iiits to an 8-word state save area defined 
on line 30. The second entry in the table is the hardware mask that is set while the 
A/D interrupt is serviced. 1B8 indicates that all other devices can interrupt the 
A/D converter. The third and final emtrj in the DCT is the address of the interrupt 
servicing program, AINTS, AINTS is found on page 4 of the driver listing, and 
will be discussed later. 

Lines 25 - 29 contain additional variables and constants which are required while 
servicing requests to this handler. These values are, in order, the device code 
of the A/D converter, a busy/done status flag, pointers to the address and data 
tables, and the number of points to be read for this call. 

Page 2 ©f the driver listing illustrates two subroutines called by the user to attach 
(detach) the A/D converter interrupt servicing routine to (or from) the RTOS 
dispatch table, ITBL. The first routine, AIDEF, clears the ACTIV flag to indicate 
that there are no active requests in the handler for data, AIDEF then issues the 
system call , IDEE to define this handler and introduce it to RTOS. An error return 
could result if the A/D converter device code (2l8) already was assigned to some 
other device. This would hap|:^n if a second call to AIDEF were issued without 
any intervening call to AICLR. AICLR removes the A/D routine from the RTOS 
dispatch vector table. 

Page 3 of the driver listing contains two subroutines, the analog read random routine 

(AIRDR) and the read request routine (AICHK). The first of these routines, AIRDR, 
is called with AC2 containing the address of a control table. This table is descrited 

on page 1 of the listing (lines 34 - 50). This subroutine first checks m'hether the 
device is currently active on another request by testing the ACTIV flag defined 
earlier (page 1, line 26). If the handler is already active, an error return is made 
to the user. If the handler is not active, the ACTIV flag is set and the request is 
Initiated. The address of the control table is saved in the active switch and the num- 
ber of points to be read is moved into the handler from the table. Since this routine 
l^rforms reads of analog inputs, two tables must be provided by the user. One 
table must contain the input point addresses to be read, and the other table (of equal 
or greater size) is used to store the analog input readings. The addresses of these 
two tables is given in the control table. Before returning control back to the caller, 
the address of the first point is fetched, sent to the converter, and the converter 
is started. 

The fourth subroutine, AICHK, is used to check the status of a call made to the 
converter. There are t\¥0 returns to the caller: busy and call completed. 
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Analog to Digital Coiwerter (Continued) 

P^e 4 of the driver listing contains the interrupt service routine, AINTS. This 
routine is entered from the RTOS interrup dispatch program with AC 2 containii^ the 
address of the A/D converter DCT and ACS containing the address of tte RTOS 
interrupt dismissal program. AINTS reads the new c»nverted value, saves it in the 
user -supplied data buffer, and then ctecks to see if ttere are additional pjints to be 
read, ff there are, it initiates tte next conversion. If tMs was the last point to be 
read, AINTS sets tte status of the request to indicate that the call is completed 
and tte handler is available for the next user request. 
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External Interrupt Recognition 

The driver program given at the end of this section illustrates an interrupt servicing 
routine which readies a user task as a result of an external interrupt. This program 
illustrates a type 4066 digital interface device driver, 

Pa^ 1 of the listing is almost identical in form to the first page of the A/D driver 
listing discussed earlier. The only difference is in the variables and storage 
required by the digital interface. Here, the user must supply the address of a 
communications core location. When a call is made to attach the interrupt routine 
address to the RTOS dispatch table (page 2 of the listing), AGO must contain the 
communications core location address. After attaching the interrupt to the RTOS 
dispatch vector table, the initialization routine arms the digital interface so that it 
can cause an interrupt. 

When the external interrupt occurs, control is dispatched to the digital interface 
servicing routine, starting on line 38 of page 2. After the service routine gains 
control, it reads a sixteen-bit digital register provided by the interface. If the 
register's contents is non-zero, the contents are transmitted to a user task using 
the task call .IXMT; after this, the interrupt is dismissed. If the register's contents 
is zero, the interrupt is simply dismissed. Upon dismissal of the interrupt, the 
system re -arms the digital interface interrupts. 

A practical example of the use of such a scheme would be servicing of an 
operator's console. Such a console would generate an external interrupt indicating 
that the operator desires some form of action by the computer; the sixteen-bit register 
contents (selected by the console operator) would indicate exactly the type of action 
desired. 



3-14 



Licensed Material - Property of EMta General Corporation 



mi 
«2 

«a I OIPIIaL lNTFf?FACfc fT¥Pg 4Pfi61 DEVICE ORIvg^ 

«4 I - — .-•..•.-.-...-..-- — — — - — . — . — ..- — - 

^5 I ----..- — — -...--- — — . — --. — — --..- — 

^^ 

.TITL Dir^FV 
^« 

!1 .E^TN .lyr-T .MIkX 

!■? .NRFL 

14 

IS 0p''f*42 ,0«»S« DI0»4? I OEVlCe CODE DEFINITION 

I** 

17 I OF.VICE CONTRflL TAfeLli LAV^HT 

!S I ----^ ...... ...^ .- 

?•;! -^l-'jPirt i^(i?(;^.??1 iniDCTJ MSDCT I AOnpFsS OF DIO PCT 

PA 

02 f.i^W'11 t'^p.f»6«y4 iMSnCT; ni^AVF I iMfcRRiiPT «?TATF SAVE AREA 

23 '^c;'?«flg»f«i,M!>p 1P7 I INTFRRIIPT MASK 

94 ./.«^-P3»^■M.-^'»36» npJTS I IK=TE»«11PT RO'iTlNE ADDRESS 

?6 f AOOlTinNAt VARTARlFS AND STORAr,E y«?EO PY HANDLER 

97 I — ^ .......^ . — -..-..-.-. ^ ^-..... 

?« 

99 !^0n4«PPt^mi{* OISAVfcl .RIK Iffl I STATE SAVE A»EA 

Si* '^^fip. I4»?if4^w42 OCOOES CIO I OEVICE CODE 

31 vi«.?fl5»ctp<ic»c.<&i DICHh: n I CCiNi^HNICAT TONS ADf>«?E$S 



3-15 



1 >. 

*m 

3!4 

P5 
P6 
P7 
919 
«9 
1^ 
11 
12 
13 
14 
15 
16 
17 

1^ 
|ij 

J?l 
9? 
9J 

94 
95 
9*1 
97 

9« 

9M 

3? 
13 
3a 

35 
3.*5 
37 

3H 
3^ 

4,-) 
41 
4? 
4.S 
44 
4^ 
4fi 
47 

4 a 

4 9 

54 

5 3 
^h 
^7 
ft^ 



P'/9 Oir^FV 



'4 ft p 1 P 
-*.?«! 7 

•?i « 9 9 1? 

4P'*»91 

^ 51 f^ 9 4 
CI « r- 9 5 

a iTt ;:« p p 



<^54»16 
i4 4 f * 7 7 ^ 

r-'947*i7 
PP6^17 
l« ? I ^ =T 7 
poll 43^ 
14 ft rJ< 1 4 ? 
P P! I 4 w 1 



■^ ^^ ,4 ? 7 ' =^ 5 4 Pi 1 6 

■ 1 ? f^ 3 i,- f r^ 6 1^ 9 4 ? 

'^ ^ i'- 3 1 » 4^ 9 <■-* 7 « 3 

■■^ f^ V* 3 2 » ^ •'" ^ ^ 1 7 

'^ '^ P 3 3 ' i" 9 1 P I C' 

.* W 51 3 ^ I f.« y^ 1 4 o P 

■.■1 t't C4 3 5 I ITJ P! t 4 J-*: '.^ 



At'r*3fe 

^1 '1^37 
4 {?• i,< 4 '^ 

-» .7! ••« 4 I 

■/. fl< c^' 4 9 
: < •:» HM 3 
« f s ,.1 4 4 
•* ft f/ 4 ft 



n « 4 h 4 9 
t ? 5 f^ c-1 fS 
p ^t 1 4 ■» ? 

f^ 5 4 4 1 ^ 
1 P 9 4 ■: ' f-^ 
fM ? 7 h 9 
a9r7^1 
1777/7 

fi' p. "'I 4 !,* 1 

t 3 4-«"*9 
177777 



Llceiis*>d Material - Propsrty of Data General Cor^ration 
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<F>'RnK »ETlit^N> I DEVICE COOg fOfOI it^EAOf^ IN USE 



ST 4 3 '.'SP 
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I DISMISS THE INTERRUPT 
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HIGH PRIORITY LNTERRUPT SERVICE 

As described in the RTOS Reference Manual , special high priority interrupt devices 
may be incorporated into an RTOS system at RTDSGEN time. Tlie real time clock 
and power faH/autD restart device are two such high priority interrupt devices; 
users may also specify custom high priority interrupt service routines. 

All high priority devices have entries in a high priorit}^ interrupt dispatch table, 
. HINT . Entries in this table are scanned whenever an interrupt occurs, and only 
if no high priority device has caused an interrupt will control branch through the 
normal Interrupt table, . ITBL . All other system devices, and user devices 
announced at run time (via system call . IDEF), have entries in . ITBL . 

Interrupts are disabled whenever high priority interrupt service is being performed. 
Users writing high priority interrupt service routines must also conform to several 
programming conventions. In general, these conventions are as follows: 

1) Issue no task or system calls. 

2) Save and restore accumulators and Carry. 

3) Save the contents of location 0, and place a HALT instruction in 
location (optional). 

TTie state of Carry and the contents of accumulators AGO through AC2 must be 
saved within the routine, and these state variables must be restored before leaving 
the routine, ACS is saved by the system in location . SACS (a location within module 
INTD), and ACS too must be restored before exit is accomplished even if the 
routine didn't use ACS. The contents of location will contain the return address 
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needed for exit; tliis address should be stored in a user -pro¥ided location, e.g. , 
RET , and a HALT instruction should be stored in location 0. ITiis practice is 
adhered to by RTOS to capture program control in the event of system failure. 

The final two instructions which must be executed when leaving a high priority 
interrupt service routine are to enable interrupts and then to perform an indirect 
JMF to l±ie location containing the original return PC, e.g. , RET . Control will 
then pass to the next instruction which would have been executed had no high 
priority interrupt occurred. The following instruction sequence accomplishes 
these operations, 

.EXTiN .SAC 3 

; RESTORE AGO, ACl, AC2, CARRY 





LDA 3 @ SAC3 




INTEN 




JMP @ RET 


SAC3: 


.SAC3 


RET: 


.BLK 1 




.EiND 



***** 
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